TEXT2PS(1)                   (V1.04)                   TEXT2PS(1)



NAME
   text2ps - convert text to postscript

SYNOPSIS
   text2ps  [-r[angle]]  [-f[fontname]]  [-s[pointsize]]
            [-h[space]]  [-p[linepitch]]  [-o[offset]]
            [-oe[offset]]  [-m[topmargin]] [-w[linewidth]] 
            [-l[pagelength]]  [-v]  [-?]  [files...]

DESCRIPTION
   Text2ps reads text from standard input (or files if specified)
   and produces postscript output, suitable for sending to any
   postscript device (such as an Apple Laserwriter) or for using
   with any program that expects postscript input (such as a
   postscript interpreter used to drive some other raster
   device).  Text is normally aligned to the top and left edges
   of the imageable region of the page (usually slightly smaller
   than the physical page size), and a new page is started
   whenever text would fall below this region.  The following
   options are understood, with all values able to be given
   as integer or real:

   -r[angle]
        Rotate the page by the given angle (in degrees).  The
        default angle is 0 (portrait mode).  If -r is used
        without specifying an angle, angle is set to 90
        (landscape mode).  Angles other than 0 or 90 may cause
        text to fall outside the imageable region.

   -f[fontname]
        Set the font to the given fontname.  The default font is
        Courier.  If -f is used without a fontname, the font is
        set to Times-Roman.  The list of available fonts for the
        Apple Laser-Writer printer is:

       Courier             Times-Roman      Helvetica
       Courier-Bold        Times-Bold       Helvetica-Bold
       Courier-Oblique     Times-Italic     Helvetica-Oblique
       Courier-BoldOblique Times-BoldItalic Helvetica-BoldOblique

        Note that only the Courier family is a fixed-width font;
        all the others are variable width, and so program
        listings or columns of data will not line up.

   -s[pointsize]
        Set the pointsize (character size) to the given value (72
        points = 1 inch).  The default pointsize is 10.  If -s is
        used without specifying the pointsize, the pointsize is
        set to 12.

   -h[space]
        Increase the horizontal spacing of characters by the
        given fraction of the current pointsize.  For example,
        using `-h0.25' when pointsize = 12 causes the horizontal
        spacing to increase by 3 points. The default horizontal
        spacing is 0 i.e. the characters are placed next to each
        other, using their natural widths.  If -h is used without
        specifying spacing, spacing is set to 0.25 x pointsize.

   -p[linepitch]
        Set the line spacing of printed text to the given value
        (72 points = 1 inch).  Unless a value is specified for
        the linepitch using this option, the linepitch used will
        be equal to pointsize + 2. 

   -o[offset]
        Offset text from the left edge of the imageable region,
        by the given distance (in centimeters) on all pages.  The
        default offset is 0.  If -o is used without specifying an
        offset, offset is set to 1 cm. 

   -oe[offset]
        Offset text from the left edge of the imageable region,
        by the given distance (in centimeters) on even pages
        only.  The default offset for even pages is the same as
        that for odd pages.  If -oe is used without specifying an
        offset, offset is set to 1 cm on even pages.  Option -o
        followed by the option -oe may be used to set offsets on
        odd and even pages independently.

   -m[topmargin]
        Set the top margin to the given value (in centimeters).
        The default is to set this to 0.5 cm.  If -m is specified                       without a value for top margin, top margin is set to 1.5
        cm.

   -w[linewidth]
        Specify the number of characters per line.  Longer lines
        are folded.  The default is no folding.  If -w is used
        without specifying linewidth, linewidth is set to 72
        characters per line.  Useful with fixed-width fonts.

   -l[pagelength]
        Specify the number of lines per page.  The default is to
        start a new page whenever text falls below the imageable
        region.  If -l is used without specifying a pagelength,
        pagelength is set to 60. 

   -v
        Print the version number and quit.

   -?
        Print a list of options and quit.

AUTHOR
   Original: Stephen Frede, UNSW, Australia
   Modifications: Venu P. Gopal